Single Sign-On into Rocket.Chat with Joomla as OAuth Server
Overview
If you want to login to your Rocket.Chat site using your Joomla username and password, you can simply do it using
our Joomla OAuth Server plugin. Once you configure the Rocket.Chat with Joomla OAuth Server plugin, you can login to
your Rocket.Chat application using Joomla credentials. It also allows you to send custom user attributes to your
Rocket.Chat site as per your requirements. To know more about other features we provide in Joomla OAuth Server
plugin, you can click here.
Please follow the steps given below to configure your Rocket.Chat site with Joomla and setup the Single Sign On.
If you have any doubts or queries you can contact us at joomlasupport@xecurify.com. We will help you to configure
the plugin.
Configuration Steps
Step 1: Install Joomla OAuth Server Plugin
- Login into your Joomla site’s Administrator console.
- From left toggle menu, click on System, then under Install section click on Extensions.
- Now click on Or Browse for file button to locate and install the plugin file downloaded earlier.
- Installation of plugin is successful. Now click on Start Using miniOrange OAuth Server plugin.
- Under the Configure OAuth tab, click on the ADD button.
Step 2: Configure Rocket.Chat
- Go to https://{Your-Rocket.Chat-Domain}/admin/OAuth and sign in/login.
- Click on Add custom oauth to create a new OAuth Application(refer to image below).
- Enter a Name for the Rocket.Chat Application and Click on Send to create a new Application.
- It will be shown the Application Configuration tab.
- Click on the dropdown symbol to show the configuration.
- Configure your Rocket.Chat Application as shown below:
|
Enable:
True
|
|
URL:
Your server base url by removing trailing slash
|
|
Token Path:
/plugins/system/miniorangeoauth/miniorangeoauthtoken.php
|
|
Token Path:
/plugins/system/miniorangeoauth/miniorangeoauthtoken.php
|
|
Token Sent Via:
Payload
|
|
Identity Token Sent Via:
Header
|
|
Identity Path:
/plugins/system/miniorangeoauth/miniorangeoauthtoken.php
|
|
Authorize Path:
/index.php
|
|
Scope:
profile
|
|
Param name for Access Token:
access_token
|
|
Client ID:
Once you configure then you will get Client ID
|
|
Client Secret:
Once you configure then you will get Client Secret
|
|
Button Text:
Name you want to show on button for the end user during login
|
|
Username field:
Username
|
|
Email field:
email
|
|
Name field:
username
|
|
Merge Roles from SSO:
Enable
|
|
Merge users:
Enable
|
Step 3: Configure Joomla as OAuth Server
- Now go to the Configure OAuth tab, and enter the Client Name and Redirect URL in the respective fields.
- Then click on the Save Client button.
- Under the List of OAuth Client's table, copy the Client ID and Secret of your Client. Go to your OAuth client and paste the Client ID and Secret in the respective fileds.
- Congratulations, you have successfully configured Joomla as your OAuth Server.
